home *** CD-ROM | disk | FTP | other *** search
/ Power Utilities / Power Utilities.iso / utility / pro70 / colprint.doc < prev    next >
Encoding:
Text File  |  1993-07-07  |  13.5 KB  |  286 lines
  1.                     ColPrint version 2.0  (Column Printer)
  2.  
  3.                  Copyright (C) 1992, 1993 by Thomas M. Roddy
  4.                             All Rights Reserved.
  5.  
  6.  
  7. Introduction:
  8.  
  9. ColPrint reformats a text file into two or three 80 line columns for printing
  10. on standard 8 1/2" x 11" paper. ColPrint removes excessive blank lines and
  11. original form feeds and uses a small font to fit up to three or four
  12. times as much text on a page compared to regular printing. Many printers,
  13. from 9 pin dot matrix to laser printers, are supported. Several command line
  14. options allow you to control the actions of ColPrint.
  15.  
  16. The shareware version of ColPrint is restricted in one way. To encourage
  17. registration, it will only process the first 5000 or so lines of a file. This
  18. should be adequate to test the usefulness of the program. Please register
  19. if you find ColPrint useful. You will mailed the latest version of the program
  20. without the shareware notice and with the 5000 line restriction removed.
  21.  
  22. Rap is a word wrap program which is included in this distribution, but has a
  23. registration fee separate from ColPrint. Rap is useful for reformatting text
  24. files into specific line lengths in order to print the text files into
  25. columns. See RAP.DOC for more information.
  26.  
  27.  
  28. License and distribution information:
  29.  
  30. ColPrint is shareware. It is not public domain or free software. An order form
  31. is enclosed in the file named ORDER.FRM.  After trying it out for 14 days, if
  32. you like it and want to continue using ColPrint, please register by sending the
  33. registration fee (located in ORDER.FRM) with your name and address along with
  34. any comments or questions to the address listed. A companion word wrap program,
  35. Rap which is included in this distribution, must also be registered after 14
  36. days of use according to the instructions in ORDER.FRM.
  37.  
  38. You may NOT alter the code nor may you sell this program or any of its
  39. associated data files for any price.  You may charge a reasonable copy
  40. fee of not more than US$10 when distributing it to others as long as you
  41. clearly stipulate that ColPrint and Rap must be registered with its author
  42. if it is used beyond the trial period. Every copy of the ZIP distribution
  43. file must contain all of the files listed below.
  44.  
  45. You may (and are encouraged to) distribute the shareware version of ColPrint.
  46. Under no circumstances may you distribute a registered version of ColPrint
  47. to others.
  48.  
  49.  
  50. Disclaimer:
  51.  
  52. The author makes no claims or guarantees about the use of ColPrint and will
  53. not be held responsible for any loss of data or profits due its use or misuse.
  54.  
  55.  
  56. Compatibility:
  57.  
  58. There is no guarantee that ColPrint has been tested on your specific printer,
  59. but I believe it should work on all of the following printers or printers
  60. compatible with the following: Panasonic KX-P1124, All Epson dot matrix 9
  61. and 24 pin printers (LQ series, FX series, etc.), HP laser printers, HP
  62. DeskJet printer, IBM Proprinter X24, and NEC P2200XE. Please let me know if
  63. you can not get ColPrint to work on one of the above listed printers. I'm
  64. sure there are others that ColPrint will work with. Try it! Many dot matrix
  65. printers are compatible with one of the above.
  66.  
  67.  
  68. Files in distribution:
  69.  
  70.  COLPRINT.EXE  -   Program which prints a document using two columns
  71.  COLPRINT.DOC  -   This file - Documentation for ColPrint
  72.  RAP.EXE       -   Program which reformats text files to specified line lengths
  73.  RAP.DOC       -   Documentation for Rap
  74.  ORDER.FRM     -   Printable order form for registering ColPrint
  75.  
  76.  
  77. Product description:
  78.  
  79. ColPrint is my answer to the overwhelming amounts of paper that piles up
  80. from printing various large document files.  If you prefer to read them on
  81. paper rather than on the PC, as I do, and you want to save a few trees, I
  82. think you will find this program useful.
  83.  
  84. ColPrint can print the same text on a fraction of the amount of paper normally
  85. required.  It is not unusual to reduce a 100 page document to 30 pages (or
  86. 15 if you use both sides of the paper).
  87.  
  88. ColPrint was initially developed to take advantage of the 20 character per
  89. inch mode (pitch) of many 24 pin dot matrix printers, HP DeskJet, and laser
  90. printers. This mode permits 160 characters per line to be printed which fits
  91. two 80 character columns nicely on a single page with no space between the
  92. columns.
  93.  
  94. NOTE: Not all printers support 20 cpi (160 cpl), but most support around 17
  95. cpi (137 cpl). If you have a laser printer, check your manual to see if a 20
  96. pitch internal font comes with it.
  97.  
  98. If your printer does not support 20 cpi mode and you have a document which
  99. has 80 character lines then you need to reformat it into shorter lines using
  100. the enclosed word wrap utility, Rap, to print two columns of about 66
  101. characters on a 137 character line. If you prefer three columns, you will
  102. need to use the word wrap utility first to reformat to about 42 character
  103. lines. Otherwise the lines will be truncated when printed using ColPrint.
  104.  
  105. Rap is a word wrap program which is distributed with this program, but its
  106. use beyond 14 days requires a separate registration fee.
  107.  
  108. By default, ColPrint Reads an ASCII file, removes form feed (advances to
  109. new page) characters, removes blank lines (except for one) which occur
  110. between text, sets printer for compressed print, 8 lines per inch (80 lines
  111. per page), either 137 or 160 characters per line depending on printer type,
  112. and formats the text into columns for output. The original document remains
  113. unchanged. You can still print it out in the traditional way. ColPrint makes
  114. a guess regarding the maximum pitch of your printer. If that guess is wrong,
  115. specify a smaller line length on the command line (/L) to create smaller
  116. widths of columns.
  117.  
  118. Optionally, you can print out just the odd or just the even pages thereby
  119. allowing you to print on both sides of the paper. For example, you would
  120. print all the odd pages, flip the paper over and feed it back into the
  121. printer. Then print all the even pages. This allows you to minimize your
  122. use of paper.
  123.  
  124. I usually send the output to a file and then use DOS's print command to
  125. send it to the printer. This way the print job is queued up and I can still
  126. use my computer for other things. There is no such print spooling built
  127. into ColPrint so the computer remains occupied until the printing is complete
  128. if you send it directly to the printer (the default action).
  129.  
  130. There are several options that you can give to control the formatting of the
  131. text. For example, you can specify a left margin so that there will be space
  132. on the left side of the paper which could be hole punched for a binder. Just
  133. make sure that you shorten the line length and possibly reformat your file
  134. using Rap in order to make room for the margin. Also, you can set the number
  135. of columns, column width, and total line length of the output file (includes
  136. all columns). You can specify which type of printer you are using and whether
  137. to print just odd or even pages.
  138.  
  139. Remember, ColPrint will not automatically wrap lines (to the next line) that
  140. are longer than the column width. The lines will be truncated. Please use
  141. Rap to format the file into shorter line lengths if necessary. Then print
  142. the file using ColPrint.
  143.  
  144. Enclosed are a few batch files to help automate the reformatting of line
  145. lengths with Rap followed by the reformatting into columns by ColPrint.
  146. Consult your DOS manual if you don't understand the batch files.
  147.  
  148.  
  149. Usage: ColPrint InFile [OutFile] [/O] [/E] [/Tn] [/Cn] [/Mn] [/Wn] [/Ln] [/Pn]
  150.    where InputFile  = File to be printed
  151.          OutputFile = Destination File or printer device such as
  152.                       LPT1 (default), LPT2, COM1, or COM2,
  153.          /O = Print Odd numbered pages only
  154.          /E = Print Even numbered pages only
  155.          /Tn = Use printer commands for printer type n, where n is one of:
  156.            2  = Epson 20 cpi compatible printer - 160 chars per line (default)
  157.            1  = Epson 17 cpi compatible printer - 137 chars per line
  158.            I  = IBM Proprinter X24 compatible printer - 137 chars per line
  159.            L  = HP LaserJet compatible printer - 160 chars per line
  160.            D  = HP DeskJet compatible printer  - 160 chars per line
  161.            N  = NEC P2200XE compatible printer - 160 chars per line
  162.          /Mn = Left margin of n spaces (default = 0)
  163.          /Cn = Print using n columns (1, 2 (default), or 3)
  164.          /Ln = Total line length of output is n characters (default depends
  165.                on printer type; either 160 or 137)
  166.          /Wn = Width of each column (default = Line length/Columns)
  167.          /R  = Do NOT issue a reset to the printer before printing
  168.          /B  = Do NOT skip multiple blank lines (i.e. Print all input lines)
  169.          /G  = Use graphics character set (works on printer types 1 and 2 only)
  170.          /Pn = Pitch (characters per inch) of n. For lasers and DeskJets ONLY.
  171.  
  172. / or - are both supported for specifying options.
  173. Upper case and lower case option characters are equivalent.
  174.  
  175.  
  176. Examples:
  177.  
  178.     ColPrint TEXTFILE.TXT COM1
  179.           will print to the first serial port. Other default options are
  180.           assumed: All pages, 2 columns, 20 cpi printer, 160 line length, 80
  181.           character columns (160 characters per line / 2 columns), no left
  182.           margin.
  183.  
  184.  
  185.     ColPrint TEXTFILE.TXT LPT2
  186.           will print to the second parallel port.
  187.  
  188.     ColPrint TEXTFILE.TXT TEXTFILE.PR2
  189.           will write to a file named TEXTFILE.COL (You could then
  190.           edit it or print it using your favorite print spooler).
  191.  
  192.     ColPrint TEXTFILE.TXT TEXTFILE.COL /E
  193.           will write the even pages (after formatting of TEXTFILE.TXT)
  194.           to TEXTFILE.COL.
  195.  
  196.     ColPrint TEXTFILE.TXT /TL /L150 /C3 /M10
  197.           will write to LPT1 all pages in three columns. The line length
  198.           is set to 140 characters, so columns will be 50 characters wide
  199.           each (150 characters / 3 columns). A 10 character margin on the
  200.           left side is specified. The printer type specified is the HP
  201.           laser printer.
  202.  
  203. If you want to specify a different font or other setting to the printer, then
  204. make sure you use the /R switch. Otherwise, ColPrint will issue the "reset"
  205. command before printing which will use the default "power on" settings of
  206. the printer.
  207.  
  208. The /P option is to specify a different pitch is only valid if the printer
  209. is of type L (Laser) or D (DeskJet). The default for these printers is 20
  210. characters per inch. You may want to change it to a slightly larger value
  211. if you have the internal fonts for that pitch.  ColPrint does not come with
  212. any fonts. Check your printer's manual to see if you have a 20 cpi pitch
  213. or higher.
  214.  
  215. Most word processor programs save their files in a proprietary format with
  216. control characters. If the text file is not in ASCII format, you must convert
  217. it to ASCII. Most word processors allow you to do this.
  218.  
  219. Specifying one column is a valid option. You may find this useful after
  220. using the word wrap program to reformat the input file to 137 or 160
  221. character lines and then using ColPrint to print it out in one column -
  222. utilizing the compressed printing.
  223.  
  224. If the document you are printing has box drawing characters, then you must
  225. specify the /G option in order for the printer to use the correct
  226. character set. Of course there is a trade off. When using the graphics
  227. character set, your document should not contain any italicized characters
  228. or else they will print incorrectly. This option only works with the Epson
  229. compatible dot matrix printers (both type 1 and 2 as defined above). I
  230. believe the IBM printer will use the graphics character set by default.
  231.  
  232. COLPRINT.EXE and RAP.EXE should be placed in a directory which is in your
  233. search PATH so that you can run the programs from within other directories.
  234.  
  235.  
  236. ColPrint environment variable:
  237.  
  238. You can set an environment variable named "ColPrint" equal to the options
  239. that you want to be in effect each time ColPrint is run. ColPrint will read
  240. the environment variable prior to the command line option, so you can
  241. over ride an option in the ColPrint environment variable by specifying a
  242. different value for that option on the command line.
  243.  
  244. For example, in your AUTOEXEC.BAT, you could have this line:
  245. SET COLPRINT=/C3 /TL
  246.  
  247. so that every time you run ColPrint, it will be set up for 3 columns and a
  248. laser printer type.
  249.  
  250. IMPORTANT: Make sure there are no spaces on either side of the equal sign
  251. when defining the COLPRINT variable.
  252.  
  253. Input and output files will not be overridden, so whichever method (variable
  254. or command line) gives file names, they will be used. Since the environament
  255. variable is read first, if it specifies files, than the command line
  256. specified files are ignored.
  257.  
  258.  
  259. Return value:
  260.  
  261. ColPrint returns a value of 0 on successful completion or a 1 on error.
  262. This information is useful if you are calling ColPrint from a batch file
  263. (see ERRORLEVEL) or another program.
  264.  
  265.  
  266. Miscellaneous information:
  267.  
  268. Output files are frequently larger than the size of original file due to
  269. the additional whitespace (spaces) between columns.
  270.  
  271. Warning: you are not legally allowed to modify many copyrighted software
  272. manuals. This program should be used on your own personal files or with the
  273. permission of the document's author.
  274.  
  275. If you are interested in having ColPrint customized for a fee, contact the
  276. author at the address below.
  277.  
  278. The author can be contacted by US mail or CompuServe:
  279.  
  280.  Thomas M. Roddy              CompuServe ID:  73730,3304
  281.  7158 Harp String
  282.  Columbia, MD  21045
  283.  
  284.  
  285. Trademarks are the property of their respective owners.
  286.